Big Bottom - bass synthesizer for the Organelle
===============================================
by gur_shulman - v1.0.1

A deep analog-style bass synth with a lot of control: two band-limited
oscillators with FM, a sub oscillator and noise, a resonant 24 dB filter
with drive, two envelopes, real mono playing (legato, glide, note
priority), unison and 4-voice poly, an LFO, and an output stage with
drive, compressor, chorus and low boost. 13 ready sounds to start from.

CONTROLS
  ENCODER          turn = page, press = Organelle menu
  KEYS             play (OCTAVE -2 by default, so the keys sit in bass range)
  AUX              octave down while held (see CONTROL page)
  FOOTSWITCH       sustain (also MIDI CC64)
  MOD WHEEL        LFO depth (see CONTROL page)
  PITCH BEND       +/- 2 semitones (BEND on the KEYS page)
  EXP PEDAL        volume (once you move it)
  AUX + press      reset every setting to the default

PAGES (turn the encoder; the boxes at the top show where you are)
  SOUND        PRESET | CUTOFF | RESO | ENV AMT
  OSC 1        WAVE | OCTAVE | WIDTH | LEVEL
  OSC 2        WAVE | OCTAVE | DETUNE | LEVEL
  SUB + NOISE  WAVE | OCTAVE | LEVEL | NOISE
  FILTER       TYPE | KEY TRK | DRIVE | VEL
  FILTER ENV   ATTACK | DECAY | SUSTAIN | RELEASE
  AMP ENV      ATTACK | DECAY | SUSTAIN | RELEASE
  PLAY         MODE | GLIDE | GL MODE | PRIO
  KEYS         OCTAVE | TRANSP | VEL>AMP | BEND
  LFO          RATE | SHAPE | DEST | DEPTH
  MOD          FM | PITCH | DRIFT | SPREAD
  OUTPUT       DRIVE | COMP | CHORUS | LOW END
  CONTROL      WHEEL | AUX | FOOTSW | EXP
  SETUP        KNOBS | OUTPUT | VOLUME | LFO
  CUSTOM       any four parameters you like
  ASSIGN       knob 1-4 = what each CUSTOM knob controls (full names)

  Numbers show as a bar, choices as a row of segments. Knobs CATCH by
  default: after a page change a small notch shows where the knob is; turn
  it to the value and it takes over. KNOBS = JUMP on the SETUP page.

PRESETS (PRESET on the SOUND page - it loads the whole sound)
  MOOG BASS   saw + square, warm ladder-style filter, legato
  FAT SUB     sine + triangle + sub, round and deep
  ACID        303 style: resonant squelch, slides on legato notes
  REESE       two detuned saws, chorus, moving and thick
  PLUCK       short, punchy, for fast lines
  FM BASS     DX style: FM shaped by the filter envelope
  WOBBLE      LFO on the filter
  SH-101      pulse width modulation + square sub
  TAURUS      big pedal-bass, slow glide
  808 BOOM    sine with a pitch drop and long tail
  UNISON SAW  four voices, detuned and wide
  POLY STAB   4-voice poly for chords
  INIT        a plain saw to start from scratch
  Your own controller, keyboard and setup settings are not changed by a
  preset. Everything you change after loading is kept.

WHAT IT ALL DOES
  WAVE        SINE / TRI / SAW / SQUARE / PULSE (PULSE uses WIDTH,
              the LFO can move it: DEST = PWM)
  OCTAVE      -2 ... +1 per oscillator
  DETUNE      osc 2 fine tune, +/- 50 cents
  SUB         WAVE / OCTAVE / LEVEL on the SUB + NOISE page:
              one or two octaves under osc 1
  TYPE        filter type: LP 24 (classic bass), LP 12, BAND, HIGH
  KEY TRK     cutoff follows the keys
  DRIVE       pushes the filter input (grit)
  VEL         harder playing opens the filter
  ENV AMT     how far the filter envelope moves the cutoff (also negative)
  MODE        MONO    one voice, every note restarts the envelopes
              LEGATO  one voice, overlapping notes don't restart (slides)
              UNISON  all four voices on one note, detuned by SPREAD
              POLY    four voices
  GLIDE       portamento time (OFF at 0)
  GL MODE     ALWAYS = every note glides, LEGATO = only overlapping notes
  PRIO        which held note sounds: LAST, LOW or HIGH
  FM          osc 2 modulates osc 1's frequency (shaped by the filter env)
  PITCH       the filter envelope also bends the pitch down (808, kicks)
  DRIFT       analog drift: tiny random pitch and cutoff movement
  SPREAD      unison detune and stereo width
  COMP        glue compressor with make-up gain
  LOW END     shelf at 70 Hz, up to +12 dB
  LFO         (SETUP) FREE, or RETRIG = the LFO restarts on every note
  WHEEL       OFF / LFO DEPTH / CUTOFF / RESONANCE / DRIVE / FM
  AUX         OCT DOWN / OCT UP (while held) / HOLD (latch, LED on) /
              GLIDE (while held) / LFO (full LFO while held) / SUSTAIN
  FOOTSW      SUSTAIN / HOLD / OCT DOWN / OCT UP / GLIDE / LFO
  EXP         OFF / VOLUME / CUTOFF / DRIVE / LFO DEPTH
  OUTPUT      (SETUP) STEREO, or MONO = the same on both jacks
  VOLUME      (SETUP) the patch's output level

SETTINGS
  Everything is saved by itself to bigbottom_settings.txt in this folder
  two seconds after the last change. Organelle "Save Patch" / "Duplicate
  Patch" also keeps it, so you can keep a few versions of the patch.
  Delete the file (or AUX + press) for the defaults.

MIDI
  Notes + velocity on the Organelle's MIDI channel, pitch bend, mod wheel
  CC1, sustain CC64. CC21-24 move knobs 1-4 as usual.

TECHNICAL
  Pure Data vanilla, no externals, no samples. Oscillators read band-limited
  wavetables (10 per wave, chosen by pitch) so high notes don't alias. The
  filter is two resonant two-pole stages with signal-rate cutoff, so the
  envelopes are smooth and fast. Voices switch themselves off when silent,
  and start clean: a new note starts its oscillators at the zero crossing
  and the attack is rounded, so even the fastest attack doesn't click.

VERSION HISTORY
  v1.0.1  The name is written as Big Bottom everywhere.
  v1.0    First release.

LICENSE
  WTFPL - Do What The F*ck You Want To Public License.
